● 這章會示範如何取得歷史K棒資料

什麼是K棒?

在瞭解什麼是"K棒"之前，我們得先瞭解什麼是"K線"?
相信大部分人，不管有沒有接觸過股市，多少一定都會在某個地方看過以下這種圖

這種圖我們稱它為"線形圖"
從這張圖當中我們可以大致看出一張股票在各個時段的價位及走勢
而上面這張是"永豐金"在10/1當日的線形圖，參考資料

為了讓我們更加方便地分析整個股市的走向及脈絡，所以又有額外衍伸出了另一種圖
我們稱它為"K線圖"，如以下這張圖就是"永豐金"的"日K線圖"，參考資料

"K線圖"在股市裡是作技術分析用的，用來記錄股市某段期間的股價，主要分為日K線、週K線、月K線，分別記錄每日、每週、每月的股價變動。而它是根據股價一天(或一個週期)的走勢形成的四個價位所繪製而成的，這四個價位分別為開盤價、最高價、最低價、收盤價。而K線圖相較於線型圖來說，可以看出更多股票的資訊，所以也更有其參考的價值。

接下來就是要來談論什麼是"K棒"了，"K線"其實就是由一支一支的"K棒"所組成，那因為K棒長得很像一根根的蠟燭，所以有時候K線圖又被人稱為蠟燭圖(Candlestick Charts)，這根蠟燭本身就代表了開盤價和收盤價，而蠟燭的兩端燭芯則代表最高價和最低價。

● 收盤價>開盤價：代表股價上漲，會以紅色來表示，稱為紅K線、陽線。
● 收盤價<開盤價：代表股價下跌，會以綠色來表示，稱為黑K線、陰線。
● 收盤價=開盤價相同：稱為十字線。
● 最高價、最低價，分別是細細的上影線及下影線。
想看更多有關於K棒的詳細資訊請參考市場先生

如何用Shioaji API取得歷史K棒資料?

這裡我們一樣以"永豐金"為例，代碼為「2890」
我們來試著取得它在 9/27 ~ 10/1 一個禮拜的K棒資料
以下為其程式碼

kbars = api.kbars(
    api.Contracts.Stocks["2890"],  #先用Contract傳入要抓取的股票資料
    start="2021-09-27", #起始日期
    end="2021-10-01"  #結束日期
)

記得一樣要先將它轉為DataFrame形式，比較方便我們瀏覽，請參考Day13
轉換為DataFrame後的顯示畫面如下

由左到右行英文名詞解釋如下

• ts: 交易時間
• Volume: 成交量
• Amount: 成交總金額
• Close: 收盤價
• Low: 最低價
• High: 最高價
• Open: 開盤價

左下角的「1306 rows」代表有著1306筆的Kbars資料